Motion.SetGroupPathCamSwitch method

Uses an axis group's travel distance to control a switch that triggers a digital output. When a group travels certain distance, a switch is turned on or off. A switch can be controlled by a forward and backward movement of a group.

Namespace: IntervalZero.KINGSTAR.OpcUa.Api

Assembly: IntervalZero.KINGSTAR.OpcUa.Api (in IntervalZero.KINGSTAR.OpcUa.Client.dll) Version: 4.4.0.0

Syntax

C#VB

public KsCommandStatus SetGroupPathCamSwitch(
       int Index,
       KsCommandStatus MotionCommand,
       int SwitchLength,
       McCamSwitch[] Switches,
       int TrackLength,
       McOutput[] Outputs,
       McTrack[] Tracks,
       uint EnableMask
)

Public Function SetGroupPathCamSwitch(
       Index As Integer,
       MotionCommand As KsCommandStatus,
       SwitchLength As Integer,
       Switches As McCamSwitch[],
       TrackLength As Integer,
       Outputs As McOutput[],
       Tracks As McTrack[],
       EnableMask As UInteger,
) As KsCommandStatus

Parameters

Index [in]

Type: int

The index of an axis. Indexes are zero based.

MotionCommand [in]

Type: KsCommandStatus

The command state of the group-path motion command a cam switch attaches.

SwitchLength [in]

Type: int

How many switches in the switch array. Each track can have up to eight switches. SwitchLength ranges from 0 to 24.

Switches [in]

Type: McCamSwitch[]

Controls the switching actions. The track numbers need to be in order.

TrackLength [in]

Type: int

How many tracks in the track array. The length of the output and track must be the same. For example, if there are two outputs, there must be two tracks. TrackLength ranges from 1 to 3.

Outputs [in]

Type: McOutput[]

Selects which digital output will be controlled by the corresponding track.

Tracks [in]

Type: McTrack[]

Adds the compensation time and hysteresis to the switches on a track. TrackNumber is defined in Switches.

EnableMask [in]

Type: uint

Enables the different tracks. This parameter is 32 bits of bool. The corresponding track in the track array is enabled when its bool value is set to one.

Return value

Type: KsCommandStatus

Returns the KsCommandStatus class.

Remarks

It works the same as Motion.SetAxisCamSwitch.
Each group motion command can only be attached to a set of cam switches (maximum 24 switches).
An axis group can have up to three path-cam switches.
A set of path-cam switches can have up to three tracks.
Group path cam switches can be used with the following functions:

Other group motion functions such as InchGroup and JogGroup are not supported.

Examples

N/A